home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d11 / switch2.arc / SWITCH.DOC < prev    next >
Encoding:
Text File  |  1991-02-04  |  5.3 KB  |  156 lines
  1.  
  2.                            Switch Version 2.0
  3.                                  2/5/91
  4.  
  5.                 A FREE Utility To Switch Welcome Screens
  6.  
  7.                       Copyright 1991 by Burk Murray
  8.                             ALL RIGHTS RESERVED
  9.  
  10.  
  11.      What Switch Does:
  12.      ----------------
  13.         Switch allows you to randomly switch between an unlimited number
  14.         of ANSI and ASCII display files, so you can automatically
  15.         have a different WELCOME or GOODBYE screen displayed to each caller.
  16.  
  17.         Switch Version 2.0 now handles DOS wildcard specifications (no
  18.         more sequentially numbered files!) and supports an optional
  19.         control file for switching multiple files with a single command.
  20.  
  21.         You can run Switch from your BBS batch file, to switch screens
  22.         before each caller, or as part of your nightly maintenance
  23.         routine, for new screens every day.
  24.  
  25.  
  26.      What Switch Doesn't Do:
  27.      ----------------------
  28.         Switch doesn't clutter up your BBS directory, doesn't limit
  29.         the number of files you can choose from, doesn't need to be
  30.         registered, and doesn't mind if you wear your hair a little long
  31.         in the back, thankyouverymuch.
  32.  
  33.  
  34.      How To Set Up Switch:
  35.      --------------------
  36.         Organize the files you want to switch between (your "source
  37.         files") into one directory -- any directory.  Keep in mind that
  38.         you'll be using wildcards to pick your files.  I name my source
  39.         files WELCOME.xxx, GOODBYE.xxx, etc.
  40.  
  41.         When you run Switch, it chooses one of your source files at
  42.         random and copies it to your "target file" name, e.g.:
  43.         WELCOME.ANS, GOODBYE.ANS. Your existing target file will
  44.         be overwritten, so make sure you've got a copy of it in your
  45.         source files.
  46.  
  47.  
  48.      Syntax:
  49.      ------
  50.  
  51.      To run Switch *without* a control file, type:
  52.  
  53.  
  54.          Switch (source_name) (target_name)
  55.  
  56.  
  57.      where:
  58.  
  59.         (source_name) is the source file name, like WELCOME.*
  60.                 or GOODBYE.AN? -- mix and match wildcards as you like.
  61.  
  62.                 (source_name) can include the complete path to your
  63.                 source files. If you don't specify a path, Switch will
  64.                 only look in your current directory.
  65.  
  66.         (target_name) is the target file name -- no wildcards --
  67.                 like WELCOME.ANS.
  68.  
  69.                 (target_name) can include the complete path to your
  70.                 target file. If you don't specify a path, Switch
  71.                 will place the target file in your current directory.
  72.  
  73.  
  74.      To run Switch *with* a control file, type:
  75.  
  76.  
  77.          Switch [(control_name)]
  78.  
  79.  
  80.      where:
  81.  
  82.         (control_name) is the name of an optional control file. If you
  83.                 don't specify (control_name), Switch will use the file
  84.                 SWITCH.CTL, in the current directory.
  85.  
  86.                 Control files may include any number of lines in the
  87.                 format:
  88.  
  89.                 (source_name) (target_name)
  90.  
  91.                 See the descriptions of (source_name) and (target_name),
  92.                 above, for details.
  93.  
  94.                 (control_name) can include the complete path to your
  95.                 control file. If you don't specify a path, Switch
  96.                 will only look in your current directory.
  97.  
  98.  
  99.      Examples:
  100.      -------
  101.         C:> Switch C:\Ansi\Welcome.* C:\Qbbs\Txt\Welcome.ans
  102.  
  103.                 This example picks a source file from C:\ANSI with
  104.                 the sourcename "WELCOME.*" and copies it to the
  105.                 target_name WELCOME.ANS, in C:\QBBS\TXT.
  106.  
  107.  
  108.         C:> Switch C:\Ansi\Switch.ctl
  109.  
  110.                 This example reads the control file "SWITCH.CTL" from
  111.                 C:\ANSI and carries out the instructions inside.
  112.  
  113.  
  114.      Other Info:
  115.      ----------
  116.         Switch works with ANY file.  Try using it to liven up your NEWS,
  117.         GOODBYE or other displays, and don't forget your ASC files,
  118.         either.  If you find any novel uses for Switch, please let me
  119.         know, and I'll pass them along.
  120.  
  121.  
  122.      Disclaimer:
  123.      ----------
  124.         Switch works for me, on my computer. I make no other guarantees,
  125.         expressed or implied, as to its functionality. Use Switch at
  126.         your own risk. Just because it works here doesn't mean it won't
  127.         make you itch or convert all of your text files to Hungarian.
  128.  
  129.  
  130.      License:
  131.      -------
  132.         You are hereby licensed to use Switch indefinitely and for
  133.         whatever purposes suit you. If you like it, drop me a note via
  134.         netmail. In the unlikely event that you feel obliged to pay for
  135.         it, send a couple of dollars to your local shelter for the
  136.         homeless or to another worthy charity.
  137.  
  138.         This program may be freely distributed in any format, as long as:
  139.         1) This documentation file is included in the archive and 2) No
  140.         fee is charged for its distribution, excluding a diskette fee of
  141.         up to $5 US.
  142.  
  143.  
  144.      Thanks:
  145.      ------
  146.         Teri Bonde, for patience with a beginning C programmer (me).
  147.         Gene LeDuc, whose excellent utility ALIAS convinced me to
  148.                 contribute to the pool of Freeware.
  149.  
  150.  
  151.   Burk Murray
  152.   Antelope Freeway BBS
  153.   Fidonet 1:3800/4
  154.   Baton Rouge, Louisiana
  155.   (504) 387-4015
  156.